پرش به مطلب اصلی

سفارش OCO

👋 Introduction​

فرض کن می‌خوای یه سفارش OCO ثبت کنی. این سفارش ترکیبی از سفارش لیمیت و استاپ لیمیت هست.
تو این نوع سفارش، دو سفارش به‌طور همزمان تو بازار قرار می‌گیرن؛ اگه یکی از اونا انجام بشه، اون یکی به‌صورت خودکار لغو می‌شه. این نوع سفارش برای مدیریت همزمان خرید و فروش تو بازار خیلی مفیده.

مثال کاربردی:​

فرض کن 1 بیت کوین داری و میخوایی وقتی رسید به قیمت 70000 دلار بفروشی. ولی اگر قیمت ریخت تا 58000 دلار، برای جلوگیری از ضرر بیشتر روی قیمت 57990 بیت کوین ها رو بفروش.

🔗 Endpoint​

POST /api/v1/odr/orders/

⏱ Rate Limit​

اطلاعیه

حداکثر تعداد درخواست‌های مجاز برای ثبت سفارش برابر با 5400 درخواست در ساعت هست.

📨 Request​

curl --location --request POST 'https://api.bitpin.ir/api/v1/odr/orders/' \  
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \  
--header 'Content-Type: application/json' \  
--data '{
    "symbol": "BTC_USDT",
    "type": "oco",
    "side": "sell",
    "base_amount": 1,
    "oco_target_price": 70000
    "stop_price": 58000,
    "price": 57990,
}'

🛠 Request Params​

ParameterDescriptionTypeRequiredExample
symbolنام بازار (مثل USDT_IRT)StringبلهUSDT_IRT
typeنوع سفارش (oco)Stringبلهoco
sideساید سفارش (buy یا sell)Stringبلهbuy
oco_target_priceقیمت هدفIntegerبله70000
stop_priceقیمت استاپIntegerبله58000
priceقیمت سفارش لیمیت اولیهIntegerبله57990
base_amountمقدار رمزارز برای خرید یا فروشIntegerبله100

Additional Notes​

  • سفارش OCO بهت این امکان رو می‌ده که دو هدف رو همزمان دنبال کنی؛ اگه یکی از سفارش‌ها فعال بشه، دیگری به‌صورت خودکار لغو می‌شه.
  • قیمت استاپ و قیمت سفارش لیمیت باید به دقت تنظیم بشن تا سفارش‌های شما به‌درستی اجرا بشن.